Inside Macintosh: QuickTime Components

Previous | Chapter Top | Chapter Contents | Next

Indirect Functions

This section describes functions that are invoked by the Image Compression Manager but do not correspond to functions called by applications. The Image Compression Manager may call these functions at any time.

CDPreCompress

Your component receives the CDPreCompress request before compressing an image or a band of an image. The Image Compression Manager also calls this function when processing a sequence. In that case, the Image Compression Manager calls this function whenever the parameters governing the sequence operation have changed substantially. Your component indicates whether it can perform the requested compression operation.

pascal ComponentResult CDPreCompress
                                         (CodecCompressParams *params);
params
Contains a pointer to a compression parameters structure. The Image Compression Manager places the appropriate parameter information in that structure. See "The Compression Parameters Structure," for details.

DESCRIPTION

Your component should return a 0 result code to indicate that it can handle the request. In addition, your component indicates any limitations on its capabilities in a compressor capability structure (see "The Compressor Capability Structure," for details). Your component should return a result code of codecConditionError if it cannot field the compression request.

Only compressors receive this request.

RESULT CODES

noErr

0

No error

paramErr

-50

Invalid parameter specified

codecConditionErr

-8972

Component cannot perform requested operation

CDBandCompress

Your component receives the CDBandCompress request to compress an image or a band of an image. The image may be part of a sequence.

pascal ComponentResult CDBandCompress
                                         (CodecCompressParams *params);
params
Contains a pointer to a compression parameters structure. The Image Compression Manager places the appropriate parameter information in that structure. See "The Compression Parameters Structure," for a complete description of the compression parameters structure.

DESCRIPTION

Only compressors receive this request.

RESULT CODES

noErr

0

No error

paramErr

-50

Invalid parameter specified

codecSpoolErr

-8966

Error loading or unloading data

codecAbortErr

-8967

Operation aborted by the progress function

CDPreDecompress

Your component receives the CDPreDecompress request before decompressing an image or a band of an image. The Image Compression Manager also calls this function when processing a sequence. In that case, the Image Compression Manager calls this function whenever the parameters governing the sequence operation have changed substantially. Your component indicates whether it can perform the requested decompression operation.

pascal ComponentResult CDPreDecompress
                                         (CodecDecompressParams *params);
params
Contains a pointer to a decompression parameters structure. The Image Compression Manager places the appropriate parameter information in that structure. See "The Decompression Parameters Structure," for a complete description of the decompression parameters structure.

DESCRIPTION

Your component should return a 0 result code to indicate that it can handle the request. In addition, your component indicates any limitations on its capabilities in a compressor capability structure (see The Compressor Capability Structure for a description of that structure). Return a result code of codecConditionError if your component cannot field the decompression request.

Only decompressors receive this request.

RESULT CODES

noErr

0

No error

paramErr

-50

Invalid parameter specified

codecConditionErr

-8972

Component cannot perform requested operation

CDBandDecompress

Your component receives the CDBandDecompress request to decompress an image or a band of an image. The image may be part of a sequence.

pascal ComponentResult CDBandDecompress
                                         (CodecDecompressParams *params);
params
Contains a pointer to a decompression parameters structure. The Image Compression Manager places the appropriate parameter information in that structure. See "The Decompression Parameters Structure," for a complete description of the decompression parameters structure.

DESCRIPTION

Only decompressors receive these requests.

RESULT CODES

noErr

0

No error

paramErr

-50

Invalid parameter specified

codecSpoolErr

-8966

Error loading or unloading data

codecAbortErr

-8967

Operation aborted by the progress function


© 1997 Apple Computer, Inc.

Previous | Chapter Top | Chapter Contents | Next